home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / show / Show.lha / docs / Show.readme < prev    next >
Text File  |  1999-02-07  |  5KB  |  167 lines
  1. Short:      Cybergfx only picture viewer V1.14
  2. Uploader:   al.renard@infoboard.be(Alain Renard)
  3. Author:     al.renard@infoboard.be(Alain Renard)
  4. Type:       gfx/show
  5. Version:    1.14
  6.  
  7. New in version 1.14
  8. ===================
  9. - Show can now be started from WB.
  10. - Preferences grouped into a window.
  11. - While browsing the memorized pictures in the 'Goto memorized' window, you now see
  12.   the images directly.
  13.  
  14. New in version 1.13
  15. ===================
  16. - Added the LIST/K argument in the command line. See Below.
  17.  
  18. New in version 1.12
  19. ===================
  20. - The grayscale images are now loaded/saved as grayscale in TIFF format
  21. - Added Gamma for PNG loading
  22. - More prefs are saved now
  23.  
  24. New in version 1.11
  25. ===================
  26. - Load and save TIFF images.
  27. - Now you can resize the picture freely.
  28. - New menu item: Gamma correction.
  29. - ATTENTION : ixemul.library is now needed!
  30. - ATTENTION : new prefs file format...sorry! :(
  31.  
  32. What is it?
  33. ===========
  34. Show is a picture viewer for CyberGraphics systems.
  35. It can decode the next picture formats:
  36. - JPEG,PNG,GIF,TARGA,BMP,PPM,TIFF
  37. and can save in
  38. - JPEG,PNG,TIFF and RAW
  39. It open on a CyberGraphics screen (16/24bits) only.
  40.  
  41. Invocation from a shell:
  42. ========================
  43.     Show    PATTERN,MODEID=ID/K/N,LOOP=LP/S,NOERROR=NE/S,GETMODEID=GM/S,
  44.             PROGRESS=PG/S,CRYPT=CR/S,PRESERVE=PR/S,OVERWARN=OW/S,CLICK=CL/S,
  45.             LIST=LI/K,JPGQUAL=JQ/K/N,JPGGRAY=JG/S,JPGSIZE=JS/K/N
  46.  
  47. PATTERN:
  48.     - Just a filename, eg : RAM:T/mypic.jpg
  49.     - A pattern, eg: RAM:T/#?30#?.tiff
  50.     - A directory, eg: RAM:T/
  51.       Equivalent to RAM:T/#?
  52.       (You have to put the '/' at the end to indicate a directory!)
  53.  
  54. MODEID=ID/K/N:
  55.     The screen mode (in decimal)
  56.  
  57. LOOP=LP/S:
  58.     If you want endless loop in viewing.
  59.  
  60. NOERROR=NE/S:
  61.     If you do not want the errors being reported.
  62.  
  63. GETMODEID=GM/S:
  64.     Force the mode requester to appear before the program starts.
  65.  
  66. PROGRESS=PG/S:
  67.     Open the progress window when loading a picture.
  68.  
  69. CRYPT=CR/S:
  70.     Save files crypted.
  71.  
  72. PRESERVE=PR/S:
  73.     Preserve files dates.
  74.  
  75. OVERWARN=OW/S:
  76.     Open a requester to ask if you want to overwrite a file.
  77.  
  78. CLICK=CL/S:
  79.     Click with the mouse in the main window loads the next picture.
  80.  
  81. LIST=LI/K:
  82.     Take precedence over the FILES argument.
  83.     When present, Show will read the list file given instead of reading images directly.
  84.     The list file is made of lines of text, each of which is a file name.
  85.  
  86.     Example:
  87.         Show LIST RAM:mylist
  88.  
  89.         and the content of the file RAM:mylist is:
  90.  
  91.         WORK:pics/png/john.png
  92.         WORK:pics/tif/blue_parrot.tif
  93.         DATAS:mypics/eros/Regina.jpg
  94.         ...
  95.  
  96. JPGQUAL=JQ/K/N:
  97.     JPEG save quality (default=80).
  98.  
  99. JPGGRAY=JG/S:
  100.     Load JPEG in grayscale.
  101.  
  102. JPGSIZE=JS/K/N:
  103.     JPEG picture sizing when loading (0=auto, 1=full, 2=1/2, 4=1/4, 8=1/8; default=1).
  104.  
  105. These options take precedence over the preferences saved.
  106. You can also invoque Show simply by
  107.     Show
  108. and a filerequester will appear for you to choose your files.
  109.  
  110. Invocation from Workbench:
  111. ==========================
  112.     The tooltypes are the same than when starting from a shell except there are no
  113.     'LIST' or 'PATTERN'.
  114.     You can use the shortcuts.
  115.  
  116. Usage:
  117. ======
  118. Not much to say, apart for the Compose menu:
  119. Compose allow you to...compose several images in a big one.
  120. To achieve that, you have to 'memorize' the images first.
  121. So say you want to compose image1.jpg, image2.jpg, image3.jpg and image4.jpg:
  122.     - a) load the images (!)
  123.     - b) while each image is displayed, memorize it (menu 'Image/Memory/Memorize Image')
  124.     - c) compose (menu 'Image/Memory/Compose Memorized Images')
  125. Here you can choose the layout and the space between images.
  126. Press 'OK' to save it.
  127. Note: Pressing HELP in the main window help to remember some keyboard shortcuts
  128. while composing or cropping.
  129.  
  130. XPK:
  131. Files compacted/crypted with XPK are OK.
  132. You can even crypt your images from within the program.
  133.  
  134. Preferences:
  135. ============
  136. The preferences are saved in ENVARC:Show.prefs ('Save') and ENV:Show.prefs ('Use').
  137. Files Comment are always preserved.
  138.  
  139. You can customize the keyboard as you like.
  140.  
  141. Versions:
  142. =========
  143. There are 2 versions, one for 68000 and the other for 68040 *AND* a FPU.
  144.  
  145. And...This program is TOTALLY FREE ;)
  146.  
  147.  
  148. Notes:
  149. ======
  150.  
  151. a) I'm NOT a programmer, so please forgive me if you find bugs!
  152.    Anyway, your comments are always welcome; PLEASE email me
  153.    if you have bugs reports, comments, encouragements, etc...
  154.  
  155. b) Yes, this program still lacks many things!
  156.    I would like to have datatypes support, but I dont have a
  157.    clue how to gain control over the image datas in this case.
  158.    (If YOU know how to do this, let me know...)
  159.  
  160. c) Compiled with gcc-2.7.2.1.
  161.    It is slow and (IMHO) buggy, but it's free!
  162.  
  163. END.
  164.  
  165.  
  166.  
  167.